Bentley Automation Service Help

To Create an i-model Transformation Job

This example shows how to apply an existing transformation template to a new transformation job that processes documents in the input set.

This procedure assumes that you have already created and imported the necessary transformation script.

  1. In the Bentley Automation Service Browser, right-click the Job Definitions folder and select New > iCS for i-models Job.
  2. In the ProjectWise Datasource Selection dialog, select and log in to the datasource containing the documents you want to process.


    Note: In order to log in, the following must be true:
    • The specified user must have non-expiring credentials.
    • The ProjectWise working directory of the specified user must exist on this computer.
    • The computer you are working from must be included in the selected server's Trusted Server list.

    If the user is based on a Windows account, the user name syntax is Domain\user.name.

    If your datasource is not in this list, you need to configure your ProjectWise network on this computer.

    See the Bentley Automation Service Implementation Guide if you need to configure any of these things.

    After logging in, the Job Builder dialog opens a blank job definition form for you to configure.

  3. On the Input Files tab, either add the existing i-models you want to transform, or add the source documents you want to create i-models from and then transform.

    Use the icons across the top of the tab to add the items you want. See Defining the Input Set for details.

  4. On the iCS for i-models tab, do the following:
    1. Turn on Associate transformation template.
    2. Click the ... button to select which transformation template you want to use.

      The Select Document dialog opens.

    3. Select the transformation script (XML file) that you previously imported and click OK.

      Bentley i-model Transformer's Transform Builder opens with the transformation template loaded.

      The Transform Builder always loads the transformation script in read-only when opened from the Job Builder dialog, so that you cannot add or delete any transformations, rearrange or disconnect transformations, or change any parameters that are not file paths. If you need to edit the script, you need to check it out from ProjectWise and then edit it locally as usual. See To Edit a Transformation Script for details.

      The settings that appear in the Required and Optional sections depend on which transform is selected. See the Bentley i-model Transformer help for details.

    4. In the Required and Optional sections, make changes to any file path parameters as needed.

      While the transformation script is read-only, any template parameter that is a file path can be edited. Any template parameter that is not a file path is disabled.

      To change an input path parameter, click in the parameter field (for example, Input i-model Path) and click the ... button that appears in the field. In the Select Input dialog, change the Input Type to Input Set.

      To change an output path parameter, click in the parameter field (for example, Output i-model Path), and click the ... button that appears in the field. In the Select Destination dialog, you can see that the parameter is defined by a combination of destination and naming convention profiles. For each type of profile you can use one of the delivered profiles as is, edit them, or create and use your own. To create or edit profiles, click the ... button next to a profile which opens the profile manager dialog for that type of profile.

      See Creating and Editing Destination Profiles and Creating and Editing Naming Convention Profiles for i-models.

    5. When finished editing parameters of the transformation template, click Save on the Transform Builder.
  5. Click OK on the Job Builder dialog.
  6. In the Save As dialog, enter a name for the job and click Save.

The job is saved. Now you can run this job as usual (right-click the job and select Start > Full) to test the results.

Parent topic: i-model Transformation Workflow